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#include <stdio.h> 
#include <string,h> 
#include <stdlib.h> 
#include <inalloc.h> 

#define SEPARATORS " " 

#define END_OF_LINE_SEPARATOR " \t\n" 

#define DEF_FILE_PREAMBLE ";%s\iiNAME \ " %s . exe\ " \nEXPORTS\n" 

#define DEF_FILE_PREAMBLE_DYNAMOD " ; %s\nLIBRARy \ " %s . dll\ " \nEXPORTS\n" 

#define F "f« 

#define BUFSI2E 2048 

#define PREFERRED "Preferred" 

#define LOAD "load" 

#define IS "is" 

#define aDDRESS "address" 

#define ADDRESS "Address" 

#define PUBLICS "Publics" 

#define BY "by" 

tdefine VALUE "Value" 

#def ine COLON ' : ' 

#define COMPARE_ADDRESS 14 

#define COMPARERS YMBOL 26 

#define DYNA "TDYNA" 

#define DFLAG VD" 

#define AFLAG "/A" 

tdefine BASE 16 

#define TRUE 1 

# define DATA "DATA" 

#def ine DATA_NULL " " 

#define GLOBAL_COMMENT "; Global variables start here (I hope)" 
#define DEF "def" 



This program takes a program map file {.map) and converts it 
into a module definition file {.def) that will be used to 
create an import library (.lib) that will satisfy any and all 
external references in the dynamodule {.dll) that exist solely in the 
original program (.exe). This results in a dynamodule that is 
the smallest possible size. 



int f ind_string (char *src, long *base_address) 

{ 

static char *stop„buf[] = {ADDRESS, PUBLICS, BY, VALUE, "\0"}; 
static char *address_buf [ ] = {PREFERRED, LOAD, aDDRESS, IS, "\0"}; 
char **continue_search; 
char * token ; 

static base_flag = 1; 

// Return if not end of mapfile preamble or base address 
if ({token = strtok (src , SEPARATORS) ) == NULL) { 

perror ( " strtok" ) ; 

return -1; 

} 

if {base_flag) { 

continue_search = address_buf; 
} else { 

continue_search = stop_buf; 



} 

if (strcmp (token, *continue_search+-i-) ) { 
return 0; 

} 

// Make sure 

while ( **continue_search) { 

if {{token = s trt ok (NULL, SEPARATORS) ) == NULL) { 
perror { " strtok" } ; 
return -1; 

} 

if (strcmp ( token, *continue_search++) ) { 
return 0 ; 

> 

} 

// Get the base address 
if (base_flag) { 

if {(token = strtok (NULL, SEPARATORS) ) == NULL) { 

perror ( "strtok" ) ; 

return -1; 

} 

if { (*base_address = strtol ( token, (char **)NULL, BASE)) 

0) { 

perror ( " strtol " ) ; 
return -1; 

} 

base_f lag-- ; 

continue_search = stop_buf; 
return 0; 

} 

return 1; 

} 



int get_syinbol (char *src, char **syinbol, int *skip, int *fileflag, int 

dynaflag, char **address) 

{ 



char * filenames- 
static char tbuf [BUFSIZE] ; 



// Copy string to temporary buffer since strtok is destructive and 
we still need the entire string 

if (strcpy (tbuf , src) == NULL) { 

perror (" strcpy" ) ; 

return -1; 

} 

// Skip section information 

if ({*symbol = strtok (tbuf , SEPARATORS) ) == NULL) { 
perror ( "strtok" ) ; 
return -1; 

} 

// Read symbol name 

if {{^symbol = strtok (NULL, SEPARATORS) ) == NULL) { 
perror ( "strtok" } ; 
return -1; 

} 

// Get address 

if ((*address = strtok (NULL , SEPARATORS) ) NULL) { 
perror ( "strtok" ) ; 
return -1; 



// Get function declarator 

if ((filename = s trt ok (NULL, SEPARATORS) ) == NULL) { 
perror ( " strtok" ) ; 
return -1; 

} 

// Check to see if token is filename or not 

if (strcmp { filename, F) ==0) { 

// Differentiate globals from functions 

(*fileflag)++; 
// Read filename 

if ((filename = strtok (NULL, SEPARATORS) ) == NULL) { 
perror ( "strtok" ) ; 
return -1; 

} 

} 

/* 

* Eliminate entries that are dynamically linked. 

* We only want references that are statically linked in the .exe 

because 

* Microsoft won't let me search this import lib last without 

* putting all the default libraries on the link command line. 

* Makes for a smaller import lib anyway. 

* Also skip if global variable and dynamod .def file is selected. 
*/ 

if (strchr( filename, COLON) ! = NULL 1| (dynaflag && ( i *f ilef lag) ) ) 

{ 

(*skip) ++; 

if (*fileflag) { 

(*fileflag}--; 

} 

} 

return 0 ; 



int skip„map_f ile_preamble (FILE *fp, char *buf, long *base_address ) 
{ 

int again = 1 ; 

/* read until 'Address Publics by Value' */ 
while (again) { 

if (fgets (buf , BUFSIZE, fp) ==NULL) { 

perror ( " fgets " ) ; 

return (-1) ; 

} 

switch (f ind_string{buf , base__address) ) { 

case 0: break; 

case 1: again-- ; break; 

default: return{-l) ; 

} 

} 

// Skip to first symbol entry 
if (fgets (buf , BUFSIZE, fp) == NULL) { 
perror ( *' fgets " ) ; 
return (-1) ; 



return 0; 



char *get_program_name (FILE *map„f ile_name, char *buf) 
{ 



char *tok_ptr; 



// Read first line of mapfile to get program name 
if {fgets (buf , BUFSI2E, map_f ile_name) =- NULL) { 

perror ( " f gets " ) ; 

return NULL; 

} 

// Strip end of line- 

if {(tok_ptr = strtok(buf .END_OF_LINE_SEPARATOR) ) == NULL) { 
perror ("strtok") ; 
return NULL; 

} 

return tok__ptr; 

} 

int write_def_f ile_preamble (FILE *fp, char *program_name, int dynaflag, 

char *def_f ile_path) 

{ 

// Set up the .def file 
if (fprintf{fp, 

dynaflag?DEF_FILE_PREAMBLE_DYNAMOD:DEF_FILS_PREAMBLE, def_f ile_path, 
program_naine) < 0) { 

perror ( " fprintf " ) ; 

return -1; 

} 

} 

int write_def_f ile (FILE *fp, char '^symbol r int *fileflag, int dynaflag, 

long offset) 

{ 

static ordinal = 1; 
static first_global = 1; 

// Write the symbols out, removing any leading , to the .def 

file 

if (idynaflag) { 

if ( ! (*fileflag) ( f irst_global ) ) { 

fprintf (fp, "%s\n" , GLOBAL_COMMENT ) ; 
f irst_global-- ; 

} 

if (fprintf (fp, "%s @%d NONAME %s \n" , symbol [ 0] == 
?++symbol: symbol, ordinal++, ( *f ile flag) ?DATA_NULL: DATA) < 0) { 
perror { " f print f " ) ; 
return -1; 

} 

//No global variables in the dynamod file 
} else { 

if {*fileflag) { 

if {fprintf (fp, "%s @%d NONAME Ox%x\n'\ symbol [ 0] == 
?++symbol : symbol , ordinal++, offset) < 0) { 

perror ("fprintf ") ; 
return -1; 

} 

} 

} 

if (*fileflag) { 

(*fileflag)--; 

} 

return 0; 

} 



int read_inap_f ile (FILE *fp, char **syinbol, int *skip, int *£ileflag, int 

dynaflag, char **address) 

{ 

char *bufp; 

static next_flag = 0; 
static again_flag = 1; 

static char buf [BUFSIZE] , tempbuf [BUFSIZE] ; 

// Determine which buffer to use 
if (next_flag) { 

bufp - tempbuf; 

next„f lag-- ; 
} else { 

bufp = buf; 

next_f lag+-i-; 

} 

// Get next line 

if (f gets (bufp, BUFSIZE, fp) ==NULL) { 
perror { " f gets " ) ; 
return -1; 

} 

// Get next line if necessary 
if (again_flag) { 

again_f lag-- ; 
if (next_flag) { 

bufp = tempbuf; 
next_f lag-- ; 
} else { 

bufp = buf; 
next_f lag++ ; 

} 

if (fgets (bufp, BUFSIZE, fp) == NULL) { 
perror ( " fgets " ) ; 
return -1; 

} 

} 

// Compare address of symbols 

if (strncmp (tempbuf , buf. COMPARE^ADDRESS) ==0) { 

// If same choose the one the linker won't complain about! 
if (strncmp( tempbuf . buf, COMPARERS YMBOL) > 0) { 

next_f lag = 1 ; ' 
} else { 

next_flag =0; 

} 

// Need two fgets instead of one next time 
again_f lag++ ; 

} 

// Quit if done 
if (bufp[0] != ' ') { 
return 0; 

} 

if (get_symbol (next_f lag?tempbuf :buf , symbol , skip, f ilef lag, 
dynaflag, address) ) { 

print f ( "Cannot get__symbol\n" ) ; 
return -1; 

} 

//next_flag ? next_flag-- : next_flag++; 



return 1; 

} 



Arguments to main: 

* argv[l] = /A or /D depending on context 

* argv[2] = name of map file {.map) 

* argv[3] = name of module definition file (.def) 
+ 

* Returns: 

* 0 on success 

* -1 on error 
V 

void main(int argC; char **argv) 
{ 

char *symbol, *name_buf, *address, buf [BUFSIZE] , 
rel_path_buf [BUFSIZE] , 

abs_path_buf [BUFSIZE] ; 
FILE *map„f ile_name, *def_f ile_name; 
long base_address , offset; 

int skip = 0 ; 
int fileflag = 0; 
int dynaflag = 0; 

// Parse args for correct flag and arg count, 
if (argc != 4) { 

printf C " Incorrect Argument Count\n"); 

exit ("1) ; 

} 

if {strcmp{argv[l] ,DFLAG) == 0) { 

dynaf lag++ ; 
} else { 

if {strcmp(argv[lj ,AFLAG) i= 0) { 

printf {" Incorrect Arguement . Argument 1 must be 
either /D or /A\n" ) ; 

exit {-!) ; 

} 

} 

// Open map file 

if ( (map_file_name = f open (argv[2 ] , "r " ) ) == NULL) { 
per r or ( " f open" ) ; 

printf ( "Cannot open %s \n*' , argv [2 ] ) ; 
exit(-l); 

} 

// Create module definition file 

if ( (def_file_name = f open (argv [3 ] , "w" ) ) == NULL) { 
per r or ( " fopen" ) ; 

printf ( "Cannot create %s \n" , argv[3 ] ) ; 
exit (-1) ; 

} 

// Get program name 

if { (name_buf = get_program_name (map_f ile„name, buf ) ) == NULL) { 
exit (-1) ; 

} 

// Get location of application .def file 

if (strcpy {rel_path_buf , argv[2]) NULL) C 

perror { "strcpy" ) ; 

exit (-1) ; 

} 



if (strcpy {rel_path_buf + strlen (rel_path_buf } - sizeof (DEF) +1 , 
DEF) NULL) { 

perror ( " strcpy " ) ; 
exit(-l) ; 

} 

// Convert relatvie to absolute path 

if [_fullpath(abs_path_buf ,rel_path„buf .BUFSIZE) == NULL) { 
perror ("..fullpath") ; 
exit (-1) ; 

} 

// Write module definition file preamble 

if (writ e_„def_file_pr e amble (def_file_name, name__bufr dynaflag, 
abs_path_buf ) == -1) { 

printf { "Cannot write module definition file preamble %s 
\ n " , map_ f i 1 e_name ) ; 

exit (-1) ; 

} 

// Skip mapfile preamble 

if {skip_map_f ile_preamble (map_f ile_name, buf, &base_address) == 

1) { 

printf ( "Cannot skip mapfile preamble %s \n" ,map_f ile_name) 
exit (-1) ; 

} 

// Read and write until done or error 
while (TRUE) { 

switch {read_map_f ile {map_f ile_name ; & symbol, 5:skip, 
Scfileflag, dynaflag, ^address) ) { 

// Not Done 

case 1: break; 

// Done 

case 0 : exit ( 0 ) ; 
// Error 

default: exit (-1) ; 
} 

// Skip symbol if not statically linked in the . exe 
if (skip) { 

skip-- ; 
} else { 

// If dynamod .def file, calculate funtion offset 
if (dynaflag) { 

if {{offset = strtol (address, (char **)NULL, 

BASE) ) ==0) { 

perror ("strtol") ; 
exit (-1) ; 

} 

offset -= base_addr€ss ; 

} 

if (write_def_f ile (def_f ile_name, symbol, ^fileflag, 
dynaflag, offset) == -1) { 

exit (-1) ; 

} 

} 

} 

} 
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MICROSOFT FOUNDATION CLASS LIBRARY : dynaplay 



AppWizard has created this dynaplay DLL for you. This DLL n 
ot only 

demonstrates the basics of using the Microsoft Foundation cl 
asses but 

is also a starting point for writing your DLL. 

This file contains a summary of what you will find in each o 

f the files that 

make up your dynaplay DLL. 

dynaplay . cpp 

This is the main DLL source file that contains the defin 
ition of 

DllMain ( ) . 



dynapl ay . r c 

This is a listing of all of the Microsoft Windows resour 
ces that the 

program uses. It includes the icons, bitmaps, and curso 
rs that are stored 

in the RES subdirectory. This file can be directly edit 
ed in Microsoft 

Developer Studio. 

res \ dynapl ay . rc2 

This file contains resources that are not edited by Micr 
osoft 

Developer Studio. You should place all resources no 

t 

editable by the resource editor in this file, 
dynaplay , def 

This file contains information about the DLL that must b 

e 

provided to run with Microsoft Windows. It defines para 
meters 

such as the name and description of the DLL. It also ex 
ports 
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functions from the DLL. 
dynaplay . clw 

This file contains information used by ClassWizard to ed 
it existing 

classes or add new classes. ClassWizard also uses this 
file to store 

information needed to create and edit message maps and d 
ialog data 

maps and to create prototype member functions. 

1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 n 1 1 1 1 1 1 1 
1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 

other standard files: 

StdAfx.h, StdAfx.cpp 

These files are used to build a precompiled header (PCH) 
file 

named dynaplay. pch and a precompiled types file named St 
dAf X . ob j . 

Resource . h 

This is the standard header file, which defines new reso 
urce IDs . 

Microsoft Developer Studio reads and updates this file. 

I N 1/ / 1 n n 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 
1 1 1 1 1 1 1 1 1 1 1 1 IJ 1 1 1 

other notes: 

AppWizard uses "TODO:" to indicate parts of the source code 
you 

should add to or customize. 

1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 n 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 
I ! 1 1 11 1 n I / 1 III n 
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echo off 

if "%OS%"=="Windows_NT" goto :NT 
if not "%0S%"=="" goto .-Error 

command /€:4096 /c Dynabat2 %1 %2 %3 %4 %5 %6 %7 %8 %9 

exit 

:NT 

Dynabat2 %1 %2 %3 %4 %5 %6 %7 %8 %9 

exit 

: Error 

echo Dynamize: Environment variable "OS" must be either "Windows_NT" 
echo when running on NT or blank for Windows 95. 



echo off 

rem 

rem Check the Arg count 

rem 

if ' %6 • == ' ' goto :Args 

if not '%7' == goto :Args 

rem 

rem Check the Configuration 

rem 

set CFG=Unknown 

if %6 == DynaDebug set CFG="%2 - Win32 DynaDebug" 
if %6 DynaRelease set CFG="%2 - Win32 DynaRelease" 
if %CFG% == Unknown goto :Config 
rem 

rem Check for existence of application .def file 

rem 

if not exist %4\%6.def goto :Def__error 

rem 

rem Build the module definition file 

rem 

if exist %l\%2.def erase %l\%2.def 

Dynamap /D %l/%2.map %l/%2.def 

if not exist %l\%2.def goto :Map_error 

rem 

rem Generate the control file 

rem 

Dynagen %4/%6.def %l/%2.def 

if not errorlevel 0 goto :Gen__error 

rem 

rem Done ! 

rem 

:Done 
exit 

rem 

rem Handle the errors 

rem 

rem 

rem Remove any intermediate files 

rem 

: Error 

if exist %l\dynaplay .def erase %l\dynaplay . def 

touch %l\dynaplay .def 

if exist %l\%2.dll erase %l\%2.dll 

exit 

: Args 

rem 

rem Complain about the argument count 
rem 

echo Error: Dynamize: Wrong number of arguments. 

echo Custom build command for project %3 must be the following: 

echo Dynamod "$(OutDir)" "$ (InputName) " "$ (Wkspname) " "$(WkspDir)" "$(IntDir) 

DynaDebug 

echo Or 

echo Dynamod "$(OutDir)" "$ CinputName) " " $ (Wkspname) " "${WkspDir)" "$(IntDir) 
DynaRelease 

echo Depending on which build configuration you are running, 
goto .-Error 



: Conf ig 

rem 

rem Complain about the configuration parameter 
rem 

echo Error: Dynamize: Unknown Configuration. 

echo Custom build parameter 5 for project %3 is %6, 

echo Custom build parameter 5 must be either DynaDebug or DynaRelease. 
echo Check your custom build settings for the current configuration, 
goto .-Error 

rem 

rem Complain about ,def file 

rem 

:Def__error 

echo Error: Dynamod: Could not find file %4\%6.def 
echo Please rebuild application 
goto : Error 

rem 

rem Complain about Dynamap 

rem 

:Map_error 

echo Error: Dynamod: Could not generate module definition file 
echo Make sure that file Dynamap.exe is in your search path 
goto : Error 

rem 

rem Complain about Dynagen 

rem 

:Gen_error 

echo Error: Dynamod: Could not generate virtual filesystem 
echo Make sure that file Dynagen, exe is in your search path 
goto : Error 



at 



echo off 

rem 

rem Check the Arg count 

rem 

if f %7 ' == ' ' goto :Args 
if not '%8'== ' ' goto :Args 

rem 

rem Check the Configuration 

rem 

set CFG=Unknown 
set DYNALIB=%5\%7 .lib 

if %7 == DynaDebug set CFG="%2 - Win32 DynaDebug" 
if %7 == DynaRelease set CFG="%2 - Win3 2 DynaRelease" 
if %CFG% == Unknown goto :Config 

rem 

rem Remove the application 

rem 

if exist %l\%2.exe erase %l\%2.exe 
if exist %l\%2.ex€ goto :App_error 

rem 

rem Build the module definition file 

rem 

if exist %5\%7.def erase %5\%7.def 
jDynamap /A %l/%2.map %5/%7.def 
^^ V' if not exist %5\%7.def goto :Map_error 

y'^ rem 

^ rem Generate the .lib 

rem 

^^yOj if exist %5\%7.1ib erase %5\%7.1ib 

^link /lib /nologo /def : %5\%7 , def /out : %5\dynaplay . lib > %l\dynagarbage 
^copy %5\dynaplay . lib %DYNALIB% > %l\dynagarbage . can 



m 




^ if not exist %DyNALIB% goto :Lib_error 

rem 

rem Generate the -dbj's 
rem 

if exist %l\dynatab.dbj erase %l\dynatab . dbj 
Dynaobj %1 /A %5/%7,def 

if not exist %l\dynatab . dbj goto :Dbj_error 

rem 

rem Move the .obj's to .obd's 
rem Move the .dbj*s to , ob j ' s 

rem 

if exist %l\*.obd erase %l\*.obd 
rename %l\*.obj *.obd 
rename %l\*.dbj *.obj 

copy %l\dynatab.obj . > %l\dynagarbage . can 
if exist %l\*,dbj goto : Rename_error 

rem 

rem Check for existence of makefile 

rem 

if not exist %3.mak goto :Export_error 
rem 

rem Relink the application with the export file 

rem 

nmake /nologo /s /f %3.mak %4 CFG=%CFG% 
if errorlevel 1 goto :Nmake_error 
rem 



rem Rerename the .dbj's and . ob j ' s 

rem 

if exist %l\*.dbj erase /q %l\*.dbj 

rename %l\*.obj *.dbj 

rename %l\*.obd *.obj 

if exist %l\*.obd goto : Rename_error 

rem 

rem Create the Virtual File System 

rem 

Dynagen %5/%7.def 

if not errorlevel 0 goto ;Vfs_error 

rem 

rem Remove the extraneous files 
rem 

if not exist %5\dynaplay . exp goto :Exp__error 
if exist %5\dynaplay . exp erase %5\dynaplay . exp 
if exist %5\dynatab . obj erase %5\dynatab . obj 
if exist %l\%2.map erase %l\%2.map 

if exist %l\dynagarbage . can erase %l\dynagarbage . can 

rem 

rem Done ! 

rem 

exit 

rem 

rem Handle the errors 

rem 

rem 

rem Remove any intermediate files 

rem 

: Error 

if exist %4 erase %4 

if exist %5\%7,def erase %5\%7.def 

if exist %DYNALIB% erase %DYNALIB% 

if exist %5\dynaplay . exp erase %5\dynaplay . exp 

if exist %5\dynaplay . lib erase %5\dynaplay . lib 

if exist %5\dynatab . obj erase %5\dynatab . obj 

if exist %l\dynagarbage . can erase %l\dynagarbage . can 

exit 

:Args 

rem 

rem Complain about the argument count 
rem 

echo Error: Dynamize: Wrong number of arguments. 

echo Custom build command for project %3 must be the following: 

echo Dynamize "$(OutDir)" " $ ( InputName) "$ (WkspName) " $ (TargetPath) 

"$ (WkspDir) " " (SlntDir) " DynaDebug 

echo Or 

echo Dynamize "${OutDir)" "$ (InputName) "$ (WkspName) "$ (TargetPath) 
"$ (WkspDir) " " ($IntDir) " DynaRelease 

echo Depending on which build configuration you are running, 
goto : Error 
: Conf ig 

rem 

rem Complain about the configuration parameter 
rem 

echo Error; Dynamize: Unknown Configuration. 

echo Custom build parameter 6 for project %3 is %7, 



echo Custom build parameter S must be either DynaDebug or DynaRelease. 
echo Check your custom build settings for the current configuration, 
goto : Error 

rem 

rem Complain about application 

rem 

: App_error 

echo Error: Dynamize: Could not erase file .\%2.exe 
goto ; Error 

rem 

rem Complain about Dynamap 

rem 

:Map_error 

echo Error: Dynamize: Could not generate module definition file 
echo Make sure that file Dynamap.exe is in your search path 
goto : Error 

rem 

rem Complain about lib.exe 

rem 

:Lib__error 

echo Error: Dynamize: Could not sucessfully execute lib.exe 
echo Possible causes include : 



echo Could not find lib.exe 

echo Wrong or corrupt version of lib.exe 

echo Missing or corrupt file %l\%2.def 

echo Not running on an Intel cpu based machine 



goto : Error 

rem 

rem Complain about Dynaobj.exe 

rem 

:Dbj_error 

echo Error: Dynamize: Could not generate dynatab.dbj 
echo Make sure Dynaobj.exe is in your search path 
if exist %l\dynatab .dbj erase %l\dynatab . dbj 
goto : Error 

rem 

rem Complain about renaming files 

rem 

: Rename_error 

echo Error: Dynamize: Could not rename files 
echo Make sure .dbj and .obj files exist 
goto :Reset_files 

rem 

rem Complain about existence of makefile 

rem 

:Export_error 

echo Error: Dynamize: No makefile exists for this project, 
echo Please export makefile and rebuild, 

goto :Reset_files 

rem 

rem Complain about nmake 

rem 

:Nmake_error 

echo Error: Dynamize: Could not run nmake -f %2.mak %4 %CFG% 

echo Seek professional help 

goto :Reset_files 

rem • 



rem Remove the export file 

rem 

:Exp_error 

echo Error: Dynamize: Could not erase file %5\%2.exp 
goto : Error 

rem 

rem Rerename the .obj's and .dbj's 

rem 

;Vf s_error 

echo Error: Dynamize: Could not create Virtual File System 
echo Go bother Takashi 

goto : Error 

rem 

rem Rerename the .obj's and .dbj's 

rem 

: Reset_f iles 

if exist %l\*.dbj erase /q %l\*.dbj 
rename %l\*.obj * . db j 
rename %l\*.obd *.obj 
goto : Error 



echo off 

if "%OS%"=="Windows_NT" goto :NT 
if not "%0S%"=="" goto : Error 

command /e:4096 /c Dynabat %1 %2 %3 %4 %5 %6 %7 %8 %9 

exit 

:NT 

Dynabat %1 %2 %3 %4 %5 %6 %7 %8 %9 

exit 

: Error 

echo Dynamize: Environment variable "OS" must be either "Windows_NT" 
echo when running on NT or blank for Windows95. 



DynaPlay SDK README FILE 
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Configuration instructions for using DynaPlay with 
Microsoft Developer's Studio. 



IMPORTANT NOTE !: 

Currently the DynaPlay SDK is only configured to support 
Microsoft Developer's Studio versions 4.x with the exception of 
version 4.0 under NT. Release 5.0 is NOT supported at this tinne. 
Furthermore, the DynaPlay SDK will NOT work with version 5.0 
at this time. Furthermore, it's Microsoft's fault, not mine, at this time. 

ALSO NOTE: 

An example for the following instructions exists in the 
DynaPiay SDK. Refer to the Hangman32 workspace provided in 

c:\Program Files\DynaPlay\Examples\Hangman32 

(or wherever you installed the SDK) as an example of how to set up a 
DynaPlay workspace. Only steps 1 and 9 need be performed in order to build and 
execute this example. 

in order to use the DynaPlay SDK with Developer's Studio versions 4.x, 
the following steps must be taken after the DynaPlay SDK has been 
successfully installed: 

1. Make sure the DynaPlay executables and libraries are in the 
Developer's Studio search path. Add these directories (typically, 
c:\Program Fiies\DynaPiay\bin and c:\Program Files\DynaPlay\llb) to your 
executable and library search paths by calling up the Tools Options 
window and clicking on the Directories option. Add 

c:\Program Fiies\DynaPlay\bin 

(or wherever you installed the SDK) under executable files and 

c:\Program Files\DynaPlay\lib 

(or wherever you installed the SDK) under library files. 

Note: Check to see if the file 

dynallb.dll 

was installed in your Windows system directory (usually \Windows\System 



for Windows95 and \Winnt\System32 for NT), if you do not have write 
access to this directory, dynaiib.dl! will be installed in 

c:\Progrann Files\DynaPlay\bin 

(or wherever you installed the SDK). This will allow you to build your 
applications from within Developer's Studio but if you wish to execute 
them you must make sure that dynalib.dii is placed in a directory that 
is included in your PATH environment variable. 

2. Create the DynaPlay build configurations for your existing project. 
These configurations must be named 

DynaDebug 

and 

DynaRelease 

Create these by invoking the Build Configurations menu option and 
selecting Add. Use the configuration settings for your Debug 
configuration in creating the DynaDebug configuration and similarly use 
the configuration settings for your Release configuration in creating the 
DynaRelease configuration. 

3. After the new configurations have been created, call up the Build 
Settings window and click on the DynaDebug configuration. Hold the 
Ctrl key down while clicking on the DynaRelease configuration so that 
both configurations are selected. Now any modifications you make to 
the build settings will apply to both configurations. 

4. Under the General category for Build Settings, make sure that the 
option 

Use MFC in a shared DLL 

is selected. This is necessary for 

all MFC based DynaPlay applications and has no effect if your application 
is not MFC based. 

5. Under the C/C++ category select Optimizations. For the In-line 
function expansion setting, choose 

Disable * 

This is not absolutely 

necessary but is highly recommended until you have gained enough 
experience with DynaPlay to know how much trouble you can get into by 
not selecting this option. 

6. Under the Link category select General, For the option Object/library 
modules, add the following; 

dynatab.obj dynaplay.exp dynalib.lib 



Also, make sure the 
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Generate mapfile 

option is sefected and that the 
Link incrementally 

option is turned off, otherwise you will get an annoying warning message 
every time you build since incremental linking is incompatible with 
map generation. 

7. Cad up the Custom Build category and under Build 
command(s), add the following line: 

Dynamize "$(OutDir)'* "${InputName)" "$(WkspName)" ■'$(TargetPath)" "$(WkspDir)" "${lntDir)" DynaReleas 

You might try cutting and pasting the line above 

to make sure you get it right For the Output fi!e(s) section, add 

the following: 

$(WkspDir)\DynaReIease.def 



NOTE: 

if you can see the difference between the workspace name and the project name, you will have to use 

the project name instead of "$(InputName)". "$(lnputName)" represents the workspace name. The project 

name is shown in the project workspace window. 

For example, the workspace name is "Test" and the project name is "test" the following: 

Dynamize "$(OutDir)" "test" "$(WkspName)" "$(TargetPath)" "$(WkspDir)" "$(!ntDir)" DynaRelease 

8. Now click on the DynaDebug configuration so that only it is selected. 
Change the Custom Build information for this configuration so that 
all references to DynaRelease are changed to DynaDebug. 
The resulting lines should look like: 

Dynamize "$(OutDir)" "${lnputName)" "${WkspName)" "${TargetPath)" "$(WkspDir)" "$(lntDir)" DynaDebug 
to the Build command(s) section and 
$(WkspDir)\DynaDebug.def 

to the Output file{s) section. Finally, in the Link Project Options 
section, add the following option: 

/opt:noref 

Make sure that you scroll down to the bottom of the Project Options 
before entering the above option since Developer's Studio is likely to 
misinterpret how this option is to be parsed otherwise. 

NOTE: 

If you can see the difference between the workspace name and the project name, you will have to use 

the project name instead of "$(lnputName)". "${lnputName)" represents the workspace name. The project 

name is shown in the project workspace window. 

For example, the workspace name is "Test" and the project name is "test" the following: 



Dynamize "$(OutDir)" "test" "$(WkspName)" "$(TargetPath)" "${WkspDir)" "$(lntDir)" DynaDebug 

9. Build and execute the application in both the DynaDebug and 
DynaRelease configuration to make sure that everything is configured 
correctly. If so, you have now successfully built an application that 
has been "Dynamized" and is now ready to accept DynaPlay modules. Of 
note is the fact that you have accomplished this without making any 
modifications to th^ existing source code for the application. You 
are now ready to create the modules that DynaPlay uses to modify your 
existing application. These modules can be applied both at application 
startup and dynamically during the runtime of the application to modify 
the behavior of the application in any manner the programmer chooses. 
Not only can these modifications be performed dynamically (hence, the 
name DynaPlay) but these modifications require no forethought, that is, 
they can be made to the application after it has been created and 
distributed without prior planning as to the nature of these changes. 
The next section will discuss how to create the modules that DynaPlay 
ready applications use. 

NOTE: 

Do not change Intermediate files and Output files under the General category 
for Build Settings. 



Creating modules for use with DynaPlay ready applications 



At present, the responsibility for maintaining the source code used in the 
Dynamodules, rests with the user. This can be accomplished in a number 
of different ways, depending upon the nature of the application being 
developed. The Hangman example provided with the SDK shows 
separate directories, dynajnclude and dyna_c for holding the source code 
used in the Dynamodule. This approach allows complete freedom to modify 
the application in any way, including header file modifications, without affecting 
the source code for the original application. This could be accomplished in other 
ways, such as using Visual SourceSafe to keep track of different versions of the 
code or the user may simply decide to modify the original code itself. At present, 
the choice of which method to use is up to the user. Keep in mind the following 
requirements when making your decision: 

1 . The source code contained in the Dynamodule consists of only the changes you 
wish to make to the original application. Only those functions that are modified 
are included in the Dynamodule. 

2. The filenames of the Dynamodule source code must have the same names 

as the filenames in the original application. For example, if you modify function x() 
In file ax and function yQ in file bx, your Dynamodule will consist of code from two 
files, a.c and b.c. ax will contain only function x{) and bx will contain only function y(). 
You cannot combine both functions into one file and call it, for example, cx{ or ax 
or bx for that matter). 

Once the decision has been made as to how the Dynamodule source code will be 
maintained, the procedure for creating a Dynamodule project in Developer Studio 
is a follows: 



1 . Open the workspace that includes the originaf application. 

2 Select the menu option Insert Project and choose to create either a Dynamic-Link 
Library or an MFC AppWizard(dll) depending on whether or not your application is 
an MFC appHcation. Create this dll as a Top leve! project. You may name it anything you 

wish. 

Note: If using MFC AppWizard(dll) to create the Dynamodule, you must select the 
MFC extension dll (using shared MFC DLL) option during the creation process. 

3. If you have created an MFC Dynamodule, you must replace the "resource.h" file created 
by the AppWizard for the Dynamodule with the "resource.h" file used by the application. 
Use Windows Explorer to copy "resource.h" from the project directory of the application 
to the project directory of the Dynamodule, replying yes when asked if you wish to replace 
the existing file. 



4. Select the menu option Build Subprojects. For the Dynamodule project you just 
created, include the original application as a subproject. This will insure that if the 
original application changes in any way that it will be rebuilt before the Dynamodule 
is built. 

5- Select the Build Configurations menu option and, as you did with the original 
application, create two new configurations, DynaDebug and DynaRelease. 

6. Include two files that were created when the original application was Dynamized, 
DynaDebug. lib and DynaRelease.lib. They should reside in the root directory 
of this project's workspace. 

7. Transfer any pertinent Build Settings from the original application to the Dynamodule. 
With both the DynaDebug and DynaRelease configurations selected, make sure the 
following options are set: 

a. Under the General category, make sure that Use MFC in a Shared Dll is selected, 

if this is an MFC application. This is necessary even though the Dynamodule was 
created as a non-MFC dli. 

b. Under the C/C++ optimizations category, make sure that In-line 

function expansion is set to Disable *. 

c. Under the Link General category, make sure that Generate mapfile is selected. 

8. Select just the DynaRelease build setting and set the following options: 

a. Under the Link Project Options add the following: 

/opt:noref 

just as you did for the DynaRelease configuration of the original application. 

b. Under the Custom Build category, add the following Build command: 

Dynamod "$(OutDir)" "$(inputName)" "$(WkspName)" "$(WkspDir)" "$(lntDir)" DynaRelease 

As with the original application, you may find cutting and pasting to be useful here. 
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c. For the Output file(s) enter the following; 

$(OutDir)\$(inputName).clef 
9. Select just the DynaDebug build setting and set the following options: 

a. Under the Custom Build category, add the following Build command: 

Dynamod "$(OutDir)" "$(lnputName)" "$(WkspName)" "$(WkspDir)" "$(lntDir)" DynaDebug 



b. For the Output file(s) enter the following: 
${OutDir)\$(lnputName).def 

10. Select the Build Settings for DynaDebug.lib under the DynaRelease configuration and set 
the following: 

a. Under the General category, make sure the Exclude file from build 
option is selected. 

1 1 . Select the Build Settings for DynaRelease. lib under the DynaDebug configuration and set 
the following: 

a. Under the General category, make sure the Exclude file from build 

option is selected. 

12- Include the source files into the project that you wish to modify. Remember, 
Include only those files that contain modifications to the original application or 
the dli will be unnecessarily large. Also remember that any files included in the 
project should contain only those functions that are modified for the same 
reason. 

Note: MFC Dynamodules can still use Class Wizard, however, you must copy, exactly, the 
constructor function, the AFX_DATA_IVIAP and the AFX_MSG_MAP of the object and then 
manually add the object to the Class Wizard database. Refer to the example in the SDK for 

details. 

13. New resources may be added to MFC Dynamodules as you would normally add them to 
the application. No additional code is required to manage their use. You may also modify 
existing resources by drag and dropping them from the application into the Dynamodule 
and then editing them. No additional code is required. Also, compound resources, such 

as dialog boxes that include icons, need not include those resources that will not be modified. 
This is a new feature, available only with DynaPlay. that eliminates the need for redundant 
resources in the Dynamodule resulting in a much smaller dil than is typically capable using 
traditional programming methods. Refer to the About box in the Hangman application for 
an example of how this can be used. 

14. Build the application. 

Note: The first time you try and build an MFC Dynamodule, you will be asked if you 
wish to oven^vrite the existing "resource.h" file. This is due to having copied the 
application's "resource.h" file in step 3. Answer yes to this question. You will not be 
asked again. 



1 5. Select the Execute option. When prompted, enter the relative path name of the 
original application that was built for this Dynamoduie. Remember that the 
DynaDebug version of the original application only works with DynaDebug 
versions of the Dynamodules and that the same holds true for the DynaReiease 
version of the original application with respect to the DynaReiease versions of 
any Dynamodules created. 

The application should now execute with the code created in the Dynamodule 
substituted in place of the code created in the original application. Executing the 
Hangman32 example provided in the SDK demonstrates this. 



########################################################## 



# Following commands You can Modify # 

# * If you want to modify commands, you have to take # 

# out at first line. # 

# * The root of a terget path is the directory where # 

# is an application in user environmant. # 

# * /initscb is a control script that represents before # 

# before /initsc. /initsca means a control script that # 

# represents after /initsc. # 

# * /initscb + /initsc + /initsca is a control script for# 

# DynaModule. The control script saves XXX. dat # 

# * /dependent: is a dependent modules which is # 

# used by this DynaModule . # 

# * /eval: is the evaluating script in a Dynalnstall - exe # 

# * Use ' \ ' and CR to cont inure a line # 



; ########################################################## 

; /scinitb : ControlScript__bref ore_ ' initsc ' 

; / scinita : ControlScript_af ter_ ' initsc ' 

; /dependent :module_namel,module_name2 , . . . 

; /eval : ControlScript 

; /vf s :Sourc€_pathl Target jpath_in_VFS 

; /vf sdata : Value | Target jpath_in_VFS 

/data : C : \Program Files\Net 

Fighter\DynaModules\DynaModulel\DynaRelease\dynamodulel . dll | self andheat\dynamo 
dulel.dll 

/data : C : \Program Files\Net 

Fighter \DynaModules\DynaModule2\DynaRelease\dynamodule2 .dll | self andheat/dynamo 
dule2.dll 

/ out : c : \temp\aaa . dyp 




